特性支持(Feature Support)
随着 Rive Editor 持续迭代,某些新特性需要 Runtime 更新才能完整支持,部分场景还会引入新 API 或 API 变更。
建议尽量使用最新 Runtime 版本,以获得更好的兼容性、稳定性与性能。
你可以用本页快速判断:你的 .riv 文件所用特性,是否被目标 Runtime 支持。
警告(Warning):部分特性需要使用 Rive Renderer(渲染器)。
请先阅读:
当前明确依赖 Rive Renderer 的特性是:
- Vector Feathering(矢量羽化)
当某项特性涉及 API 迁移时,官方通常会在对应 Runtime 文档中附带迁移说明。
按 Runtime 查看支持
当前 Runtime(Current)
- Web - WebGL2(推荐)
- Web - Canvas
- React - WebGL2
- React - Canvas
- React Native(Nitro)
- Flutter
- Apple
- Android
- C++
- Unity
- Unreal
Lite Runtime
- Web - Canvas Lite
- React - Canvas Lite
Lite 版本通常 API 与标准 Canvas 版本接近,但会裁剪部分特性以减小包体。
Legacy Runtime(已弃用)
- Web - WebGL(
@rive-app/webgl) - React - WebGL(
@rive-app/react-webgl) - React Native Legacy(
rive-react-native)
建议迁移到:
- Web:
@rive-app/webgl2- React:
@rive-app/react-webgl2- React Native:
rive-nitro-react-native
按特性查看支持
官方页面使用 ✅ / 🟡 标记:
- ✅:在**当前 Runtime(不含 Legacy)**中全部支持
- 🟡:支持因 Runtime / 渲染器 / 平台能力而有差异
注意(Note):某特性即使在 Legacy 中不支持,仍可能被视为“当前 Runtime 全支持”。
主要特性清单
- Scripting(脚本)
- Data Binding(数据绑定)
- Data Binding Lists / Images / Artboards
- Right-to-Left Layouts & Text(RTL 文本与布局)
- Text Follow Path(文本沿路径)
- Vector Feathering(矢量羽化)
- N-Slicing
- Layouts(布局)
- Fallback Fonts(后备字体)
- Randomization(随机化)
- Audio(音频)
- Out-of-band Assets(带外资源)
- Text(文本)
- Follow Path(路径跟随)
- Interpolation on States(状态插值)
- Joysticks
- Solos
- Speed on States(状态速度)
- Graph Editor(图形编辑器曲线)
- Listeners(监听器)
- Mesh Deformation(网格形变)
- Caching a Rive File(缓存 Rive 文件)
- Raster Assets(光栅资源)
Legacy 特性(不建议新项目继续依赖)
- Events(事件)
- 运行时监听 Rive Events 已进入弃用路径。
- 建议改用 Data Binding 监听 Trigger 或属性变化。
- Nested Text(嵌套文本运行时赋值)
- 旧版 text run 直接改值能力处于弃用路径。
- 建议改用 Data Binding 的 string 属性绑定文本。
选型建议
- Web / React 优先 WebGL2:新特性支持与性能通常更好。
- 仅在包体敏感时使用 Lite:先确认目标特性未被裁剪。
- 新项目避免 Legacy Runtime:减少迁移成本与潜在兼容风险。
- 遇到渲染差异先检查 Renderer 路径:尤其是 Vector Feathering。
相关文档
- /docs/Runtimes/Choose a Renderer/Overview
- /docs/Runtimes/Getting started
- /docs/Runtimes/Runtime Sizes
- /docs/Runtimes/Advanced Topic/Format
版本支持矩阵(Runtime × Feature × 最低版本)
数据来源:官方
snippets/feature-support.jsx。 说明:✅ x.y.z+表示支持且给出最低版本;Not supported/Not yet supported/Deprecated为官方原文状态。
阅读建议:按需展开分组与 Runtime,避免一次性查看超长表格。
当前 Runtime(Current)
Web - WebGL2(Web - WebGL2)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ 2.34.0+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ 2.30.3+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 2.26.7+ |
| 文本沿路径(Text Follow Path) | ✅ 2.26.7+ |
| 数据绑定(Data Binding) | ✅ 2.26.6+ |
| 矢量羽化(Vector Feathering) | ✅ 2.26.0+ |
| N-Slicing(N-Slicing) | ✅ 2.23.11+ |
| 布局(Layouts) | ✅ 2.23.3+ |
| 后备字体(Fallback Fonts) | Not yet supported |
| 随机化(Randomization) | ✅ 2.15.6+ |
| 音频(Audio) | ✅ 2.15.6+ |
| 带外资源(Out-of-band Assets) | ✅ 2.11.0+ |
| 文本(Text) | ✅ 2.11.0+ |
| 路径跟随(Follow Path) | ✅ 2.11.0+ |
| 状态插值(Interpolation on States) | ✅ 2.11.0+ |
| 摇杆(Joysticks) | ✅ 2.11.0+ |
| 独奏(Solos) | ✅ 2.11.0+ |
| 状态速度(Speed on States) | ✅ 2.11.0+ |
| 图形编辑器(Graph Editor) | ✅ 2.11.0+ |
| 监听器(Listeners) | ✅ 2.11.0+ |
| 网格形变(Mesh Deformation) | ✅ 2.11.0+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ 2.11.0+ |
| 光栅资源(Raster Assets) | ✅ 2.11.0+ |
| 事件(Events,已弃用) | ✅ 2.11.0+ |
| 嵌套文本(Nested Text,已弃用) | ✅ 2.11.0+ |
Web - Canvas(Web - Canvas)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ 2.34.0+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ 2.30.3+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 2.26.7+ |
| 文本沿路径(Text Follow Path) | ✅ 2.26.7+ |
| 数据绑定(Data Binding) | ✅ 2.26.6+ |
| 矢量羽化(Vector Feathering) | Not supported |
| N-Slicing(N-Slicing) | ✅ 2.23.11+ |
| 布局(Layouts) | ✅ 2.23.3+ |
| 后备字体(Fallback Fonts) | Not yet supported |
| 随机化(Randomization) | ✅ 2.15.6+ |
| 音频(Audio) | ✅ 2.15.6+ |
| 带外资源(Out-of-band Assets) | ✅ 2.7.0+ |
| 文本(Text) | ✅ 2.1.3+ |
| 路径跟随(Follow Path) | ✅ 1.2.4+ |
| 状态插值(Interpolation on States) | ✅ 1.2.1+ |
| 摇杆(Joysticks) | ✅ 1.1.9+ |
| 独奏(Solos) | ✅ 1.1.2+ |
| 状态速度(Speed on States) | ✅ 1.0.102+ |
| 图形编辑器(Graph Editor) | ✅ 1.0.97+ |
| 监听器(Listeners) | ✅ 1.0.65+ |
| 网格形变(Mesh Deformation) | ✅ 1.0.47+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ 1.0.2+ |
| 事件(Events,已弃用) | ✅ 2.4.3+ |
| 嵌套文本(Nested Text,已弃用) | ✅ 2.21.0+ |
React - WebGL2(React - WebGL2)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ 4.26.0+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ 4.22.0+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 4.18.6+ |
| 文本沿路径(Text Follow Path) | ✅ 4.18.6+ |
| 数据绑定(Data Binding) | ✅ 4.20.0+ |
| 矢量羽化(Vector Feathering) | ✅ 4.18.0+ |
| N-Slicing(N-Slicing) | ✅ 4.16.7+ |
| 布局(Layouts) | ✅ 4.16.0+ |
| 后备字体(Fallback Fonts) | Not yet supported |
| 随机化(Randomization) | ✅ 4.9.5+ |
| 音频(Audio) | ✅ 4.9.5+ |
| 带外资源(Out-of-band Assets) | ✅ 4.5.0+ |
| 文本(Text) | ✅ 4.1.3+ |
| 路径跟随(Follow Path) | ✅ 3.0.55+ |
| 状态插值(Interpolation on States) | ✅ 3.0.54+ |
| 摇杆(Joysticks) | ✅ 3.0.49+ |
| 独奏(Solos) | ✅ 3.0.42+ |
| 状态速度(Speed on States) | ✅ 3.0.38+ |
| 图形编辑器(Graph Editor) | ✅ 3.0.34+ |
| 监听器(Listeners) | ✅ 3.0.6+ |
| 网格形变(Mesh Deformation) | ✅ 3.0.1+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ 0.0.28+ |
| 事件(Events,已弃用) | ✅ 4.3.3+ |
| 嵌套文本(Nested Text,已弃用) | ✅ 4.14.0+ |
React - Canvas(React - Canvas)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ 4.26.0+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ 4.22.0+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 4.18.6+ |
| 文本沿路径(Text Follow Path) | ✅ 4.18.6+ |
| 数据绑定(Data Binding) | ✅ 4.20.0+ |
| 矢量羽化(Vector Feathering) | Not supported |
| N-Slicing(N-Slicing) | ✅ 4.16.7+ |
| 布局(Layouts) | ✅ 4.16.0+ |
| 后备字体(Fallback Fonts) | Not yet supported |
| 随机化(Randomization) | ✅ 4.9.5+ |
| 音频(Audio) | ✅ 4.9.5+ |
| 带外资源(Out-of-band Assets) | ✅ 4.5.0+ |
| 文本(Text) | ✅ 4.1.3+ |
| 路径跟随(Follow Path) | ✅ 3.0.55+ |
| 状态插值(Interpolation on States) | ✅ 3.0.54+ |
| 摇杆(Joysticks) | ✅ 3.0.49+ |
| 独奏(Solos) | ✅ 3.0.42+ |
| 状态速度(Speed on States) | ✅ 3.0.38+ |
| 图形编辑器(Graph Editor) | ✅ 3.0.34+ |
| 监听器(Listeners) | ✅ 3.0.6+ |
| 网格形变(Mesh Deformation) | ✅ 3.0.1+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ 0.0.28+ |
| 事件(Events,已弃用) | ✅ 4.3.3+ |
| 嵌套文本(Nested Text,已弃用) | ✅ 4.14.0+ |
React Native(Nitro)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ v0.1.5+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ v0.1.4+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ v0.1.4+ |
| 文本沿路径(Text Follow Path) | ✅ v0.1.4+ |
| 数据绑定(Data Binding) | ✅ v0.1.4+ |
| 矢量羽化(Vector Feathering) | ✅ v0.1.4+ |
| N-Slicing(N-Slicing) | ✅ v0.1.4+ |
| 布局(Layouts) | ✅ v0.1.4+ |
| 后备字体(Fallback Fonts) | ✅ 0.2.7+ |
| 随机化(Randomization) | ✅ v0.1.4+ |
| 音频(Audio) | ✅ v0.1.4+ |
| 带外资源(Out-of-band Assets) | ✅ v0.1.4+ |
| 文本(Text) | ✅ v0.1.4+ |
| 路径跟随(Follow Path) | ✅ v0.1.4+ |
| 状态插值(Interpolation on States) | ✅ v0.1.4+ |
| 摇杆(Joysticks) | ✅ v0.1.4+ |
| 独奏(Solos) | ✅ v0.1.4+ |
| 状态速度(Speed on States) | ✅ v0.1.4+ |
| 图形编辑器(Graph Editor) | ✅ v0.1.4+ |
| 监听器(Listeners) | ✅ v0.1.4+ |
| 网格形变(Mesh Deformation) | ✅ v0.1.4+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ v0.1.4+ |
| 光栅资源(Raster Assets) | ✅ v0.1.4+ |
| 事件(Events,已弃用) | ✅ v0.1.4+ |
| 嵌套文本(Nested Text,已弃用) | ✅ v0.1.4+ |
Flutter(Flutter)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ 0.14.1 |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ 0.14.0-dev.1 |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 0.14.0-dev.1 |
| 文本沿路径(Text Follow Path) | ✅ 0.14.0-dev.1 |
| 数据绑定(Data Binding) | ✅ 0.14.0-dev.1 |
| 矢量羽化(Vector Feathering) | ✅ 0.14.0-dev.1 |
| N-Slicing(N-Slicing) | ✅ 0.14.0-dev.1 |
| 布局(Layouts) | ✅ 0.14.0-dev.1 |
| 后备字体(Fallback Fonts) | Not yet supported |
| 随机化(Randomization) | ✅ 0.13.4+ |
| 音频(Audio) | ✅ 0.13.4+ |
| 带外资源(Out-of-band Assets) | ✅ 0.12.0+ |
| 文本(Text) | ✅ 0.11.14+ |
| 路径跟随(Follow Path) | ✅ 0.11.6+ |
| 状态插值(Interpolation on States) | ✅ 0.11.4+ |
| 摇杆(Joysticks) | ✅ 0.11.1+ |
| 独奏(Solos) | ✅ 0.10.4+ |
| 状态速度(Speed on States) | ✅ 0.10.3+ |
| 图形编辑器(Graph Editor) | ✅ 0.10.0+ |
| 监听器(Listeners) | ✅ 0.9.0+ |
| 网格形变(Mesh Deformation) | ✅ 0.8.4+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ 0.8.1+ |
| 事件(Events,已弃用) | ✅ 0.11.17+ |
| 嵌套文本(Nested Text,已弃用) | ✅ 0.13.7+ |
Apple(Apple)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ v6.13.0+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ v6.11.0+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 6.7.4+ |
| 文本沿路径(Text Follow Path) | ✅ 6.7.4+ |
| 数据绑定(Data Binding) | ✅ 6.8.0+ |
| 矢量羽化(Vector Feathering) | ✅ 6.6.0+ |
| N-Slicing(N-Slicing) | ✅ 6.4.0+ |
| 布局(Layouts) | ✅ 6.3.0+ |
| 后备字体(Fallback Fonts) | ✅ 6.1.0+ |
| 随机化(Randomization) | ✅ 5.11.5+ |
| 音频(Audio) | ✅ 5.11.5+ |
| 带外资源(Out-of-band Assets) | ✅ 5.7.0+ |
| 文本(Text) | ✅ 5.1.5+ |
| 路径跟随(Follow Path) | ✅ 4.0.5+ |
| 状态插值(Interpolation on States) | ✅ 4.0.4+ |
| 摇杆(Joysticks) | ✅ 4.0.1+ |
| 独奏(Solos) | ✅ 3.1.9+ |
| 状态速度(Speed on States) | ✅ 3.1.7+ |
| 图形编辑器(Graph Editor) | ✅ 3.1.3+ |
| 监听器(Listeners) | ✅ 2.0.21+ |
| 网格形变(Mesh Deformation) | ✅ 1.0.18+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ 1.0.1+ |
| 事件(Events,已弃用) | ✅ 5.3.1+ |
| 嵌套文本(Nested Text,已弃用) | ✅ 6.1.0+ |
Android(Android)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ v11.1.0+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ v10.4.0+ |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 10.0.4 |
| 文本沿路径(Text Follow Path) | ✅ 10.0.4 |
| 数据绑定(Data Binding) | ✅ 10.1.0+ |
| 矢量羽化(Vector Feathering) | ✅ 10.0.0+ |
| N-Slicing(N-Slicing) | ✅ 9.12.0+ |
| 布局(Layouts) | ✅ 9.10.0+ |
| 后备字体(Fallback Fonts) | ✅ 9.7.0+ |
| 随机化(Randomization) | ✅ 9.3.5+ |
| 音频(Audio) | ✅ 9.3.5+ |
| 带外资源(Out-of-band Assets) | ✅ 8.6.1+ |
| 文本(Text) | ✅ 8.1.3+ |
| 路径跟随(Follow Path) | ✅ 6.0.1+ |
| 状态插值(Interpolation on States) | ✅ 5.1.5+ |
| 摇杆(Joysticks) | ✅ 5.0.0+ |
| 独奏(Solos) | ✅ 4.4.0+ |
| 状态速度(Speed on States) | ✅ 4.2.7+ |
| 图形编辑器(Graph Editor) | ✅ 4.2.2+ |
| 监听器(Listeners) | ✅ 3.0.8+ |
| 网格形变(Mesh Deformation) | ✅ 2.0.24+ |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ 2.0.5+ |
| 事件(Events,已弃用) | Deprecated and will be removed in future versions |
| 嵌套文本(Nested Text,已弃用) | ✅ 9.8.0+ |
C++(C++)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ Supported |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ Supported |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ Supported |
| 文本沿路径(Text Follow Path) | ✅ Supported |
| 数据绑定(Data Binding) | ✅ Supported |
| 矢量羽化(Vector Feathering) | ✅ Supported |
| N-Slicing(N-Slicing) | ✅ Supported |
| 布局(Layouts) | ✅ Supported |
| 后备字体(Fallback Fonts) | ✅ Supported |
| 随机化(Randomization) | ✅ Supported |
| 音频(Audio) | ✅ Supported |
| 带外资源(Out-of-band Assets) | ✅ Supported |
| 文本(Text) | ✅ Supported |
| 路径跟随(Follow Path) | ✅ Supported |
| 状态插值(Interpolation on States) | ✅ Supported |
| 摇杆(Joysticks) | ✅ Supported |
| 独奏(Solos) | ✅ Supported |
| 状态速度(Speed on States) | ✅ Supported |
| 图形编辑器(Graph Editor) | ✅ Supported |
| 监听器(Listeners) | ✅ Supported |
| 网格形变(Mesh Deformation) | ✅ Supported |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ Supported |
| 事件(Events,已弃用) | ✅ Supported |
| 嵌套文本(Nested Text,已弃用) | ✅ Supported |
Unity(Unity)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ v0.4.1-canary.33+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | ✅ v0.3.7-canary.142 |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 0.3.5+ |
| 文本沿路径(Text Follow Path) | ✅ 0.3.5+ |
| 数据绑定(Data Binding) | ✅ 0.3.6-canary.27 |
| 矢量羽化(Vector Feathering) | ✅ 0.3.3-canary.72+ |
| N-Slicing(N-Slicing) | ✅ 0.2.2-canary.22+ |
| 布局(Layouts) | ✅ 0.2.1+ |
| 后备字体(Fallback Fonts) | Not supported |
| 随机化(Randomization) | ✅ Supported |
| 音频(Audio) | ✅ Supported |
| 带外资源(Out-of-band Assets) | ✅ Supported |
| 文本(Text) | ✅ Supported |
| 路径跟随(Follow Path) | ✅ Supported |
| 状态插值(Interpolation on States) | ✅ Supported |
| 摇杆(Joysticks) | ✅ Supported |
| 独奏(Solos) | ✅ Supported |
| 状态速度(Speed on States) | ✅ Supported |
| 图形编辑器(Graph Editor) | ✅ Supported |
| 监听器(Listeners) | ✅ Supported |
| 网格形变(Mesh Deformation) | ✅ Supported |
| 缓存 Rive 文件(Caching a Rive File) | ✅ Supported |
| 光栅资源(Raster Assets) | ✅ Supported |
| 事件(Events,已弃用) | ✅ Supported |
| 嵌套文本(Nested Text,已弃用) | ✅ Supported |
Unreal(Unreal)
| 特性 | 支持状态 / 最低版本 |
|---|---|
| 脚本(Scripting) | ✅ v0.4.20+ |
| 数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards) | Not yet supported |
| RTL 布局与文本(Right to Left Layouts & Text) | ✅ 0.3.0a-gh |
| 文本沿路径(Text Follow Path) | ✅ 0.3.0a-gh |
| 数据绑定(Data Binding) | ✅ 0.3.0a-gh |